home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 11 / Cream of the Crop 11-1.iso / sound / sbplay25.zip / SBPLAY.DOC < prev    next >
Text File  |  1996-01-03  |  5KB  |  113 lines
  1.         
  2.         SBPLAY version 2.50 January 3, 1996 by John A. Ball
  3.  
  4.         SBPlay is a utility for playing back sound files. It works with 
  5.         Sound Blaster compatiable cards and other types of sound cards with
  6.         the use of DIGPAK drivers. It will also use the regular PC speaker. 
  7.         It does not require a sound board. To use the program type
  8.  
  9.         SBPLAY filename or SBPLAY
  10.  
  11.         where filename is the path to the file if required and filename can
  12.         include wild card characters. Filename extensions are not required.
  13.  
  14.         To use SBPlay with a DIGPAK driver you must install the DIGPAK
  15.         driver before using sbplay. I.e. type
  16.         SNDSYS    to install the driver and then use
  17.         SBPLAY    to play your sound files on a Windows Sound System board.
  18.  
  19.         After you are done the resident sound driver can be removed by
  20.         SNDSYS U
  21.  
  22.         Version 2.50 will play back Tandy Sound files (SND), Creative Labs
  23.         (VOC), Microsoft (WAV), Apple (AIF) and Amiga (IFF) & (RAW) files. 
  24.         There is also some support for MAC files and .AU files.
  25.         SBPlay will also play the samples in (MOD) files at the last used        
  26.         frequency. Try using the /X command line option to see the song
  27.         patterns. It will try to play back unknown files or raw data files 
  28.         such as MAC SND files at 11,000 samples per second. The sound files 
  29.         should be uncompressed, 8 bits, and unsigned. Note other types of 
  30.         files can be played by using the command line options to change the 
  31.         defaults. I.e. R:22000 to change the playback speed to 22,000 samples per 
  32.         second.
  33.  
  34.         SBPlay will also rip sound samples from MOD files and will create
  35.         the SAM sample files which were used to create the original mod file.
  36.         SAM files are used by MOD editors to create MOD files and usually 
  37.         contain musical instrument sounds or other sound effects. WAV and 
  38.         VOC sound files can also be created.
  39.         
  40.         SBPlay can be used to play a randomly selected sound file from a
  41.         directory with the /RAN switch. This can be used to play a different
  42.         sound file each time the computer boots by placing the following
  43.         command in the autoexec.bat file:
  44.  
  45.            SBPLAY c:\sound\*.* /s/ran
  46.  
  47.         where c:\sound is a directory containing sound files. The /s prevents
  48.         any file information from being shown on the screen and the /ran
  49.         selects any one of the files that are available.
  50.  
  51.         SBPlay is compatiable with DESQview, Windows, and OS/2. It can be used to
  52.         play back sound files by associating the sound file extension with
  53.         SBPlay in windows and DOSShell.
  54.         
  55.         If a mouse and mouse driver is present then SBPlay will use it to
  56.         select and play files. Try clicking the left mouse button on the
  57.         file to be played or the command.
  58.  
  59.         The main program is written in C and the sound routines for the PC 
  60.         speaker and Sound Blaster card are written in assembler. I used 
  61.         QuickC 2.51 with Assembler to create this program. The source
  62.         code is available see register.me for details.
  63.  
  64.         There are limitations to this program. 
  65.  
  66.         1) SBPLAY does not play back ALL sound files which have been 
  67.            compressed.
  68.         2) There are audio gaps during the playback of large sound files
  69.            on slow PCs and when using a multitasker. SBPlay will use EMS
  70.            memory to load all or as much of the sound file as possible into
  71.            expanded memory for playback.
  72.  
  73.         Problems:
  74.  
  75.         SBPlay uses the DOS environment to help find the hardware 
  76.         configuration. It looks for the BLASTER variable to determine what
  77.         the hardware address is, the IRQ, the DMA channel, and the board type.
  78.  
  79.         i.e.
  80.  
  81.         SET BLASTER=A220 I5 D1 T3
  82.  
  83.         will tell SBPlay that the Address is 220h, the IRQ is 5, the DMA
  84.         channel is 1, and the card type is 3 (SB ver 2.0). If your board
  85.         is configured for another DMA channel such as 0, the D parameter
  86.         must be D0 . If you have a Sound Blaster compatiable card and SBPlay
  87.         locks up try using T-1 to tell SBPlay that your card is not a Sound
  88.         Blaster card. If the hardware address or IRQ is not correct in the
  89.         BLASTER variable SBPlay should give you an error message and you can
  90.         use the /x parameter on the command line to find the correct hardware
  91.         information.
  92.  
  93.         The use of this program is free but you must register your use of 
  94.         this program. By registering I receive the feedback required to
  95.         keep me supporting this program and improving it. You may modify
  96.         and use the source code for your own programs. You may not distribute
  97.         modified code. Do not distribute any of my source code. Please send 
  98.         all corrrections and suggested improve-ments to John A. Ball.
  99.         
  100.         Comments and suggestions may be sent to
  101.  
  102.         ad008@freenet.unbc.edu or
  103.         jaball@netbistro.com
  104.  
  105.                 John A. Ball
  106.                 2398 Victoria Street
  107.                 Prince George, B.C.
  108.                 V2L 2M2
  109.                 Canada
  110.  
  111.         Thank-you for trying my program.
  112.         
  113.